home *** CD-ROM | disk | FTP | other *** search
/ Utilities Professional 1-1500 / Utilities Professional 1-1500 (1994)(WPD)[!].iso / 12511500 / var1330.dms / var1330.adf / UTILITIES / FileConverter.DOC < prev    next >
Text File  |  1994-03-01  |  2KB  |  84 lines
  1.  
  2.  
  3.     AGA Utilities DocFile
  4.     =====================
  5.  
  6.  
  7.   The utils covered in this docfile are:
  8.  
  9.     Iff-binary
  10.     Spriteconverter
  11.     ColourConverter
  12.  
  13.  Iff-Binary
  14.  ~~~~~~~~~~
  15.     This program will convert any IFF picture into a binary format
  16.  that you can use  in your programs. This is a very simple  utility to
  17.  use and doesn't really need much explaining. After loading Iff-binary
  18.  the different options available are listed, these let you select what
  19.  data to save with your file and how to save it.
  20.     The options are as follows :-
  21.  
  22.   (A) T - 12 bit colours values. This when saving the colours stores
  23.       them in the old 12 bit word value format, by not selecting
  24.       this they are saved as two  banks of 12 bit values for AGA
  25.       machines. ie. Changing a 128 colour screen to binary would
  26.       add a 128 words of the upper 4 bits of each RGB first then
  27.       a second set of 128 words of the lower 4 bits.
  28.  
  29.         Colour value $f4e28c would be $fe8 and $42c.
  30.  
  31.   (B) C - Cancel saving colours. Speaks for itself.
  32.  
  33.   (C) S - Sequential data. This lets you choose from an interleaved
  34.       binary file or sequential.
  35.  
  36.   (D) H - If the picture is HAM8 then this must be selected so the
  37.       right colours are saved.
  38.  
  39.     To convert your file just follow the prompts to enter your
  40.   filename, options and then the new filename.
  41.  
  42.  
  43.  
  44.  SpriteConverter
  45.  ~~~~~~~~~~~~~~~
  46.   This utility will convert a 16 colour binary data file into two
  47.  64 pixel wide format files to be included in the example file on
  48.  this disc.
  49.    The process is simple :-
  50.  
  51.   1. Draw your 16 colour image in say Dpaint.
  52.   2. Save it as a brush with a width of 64 pixels.
  53.   3. Run it through Iff-Binary and select C in the options to cancel
  54.      colour saving.
  55.   4. Now run this program and two files will be produced to load into
  56.      the program included.
  57.  
  58.  
  59.    Example - Spriteconvert df0:Mypicture.binary ram:Spritedata
  60.  
  61.    The program will add an extension of .SP1 and .SP2 to the output
  62.    file.
  63.  
  64.  
  65.  ColourConverter
  66.  ~~~~~~~~~~~~~~~
  67.  
  68.   This program will change the header file on an image saved with
  69.  Iff-binary from two banks of word data into byte values for each
  70.  RGB component for use with the AGA fade routine.
  71.  
  72.    The process is simple :-
  73.  
  74.   1. Iff-binary your 128 colour image with no options ( just press
  75.      return ).
  76.  
  77.   2. Now run this program and it will give you the required file.
  78.  
  79.    Example - Colourconvert df0:Mypicture.binary ram:Mycolours 128
  80.  
  81.    The value 128 must be added so that the utility knows how many
  82.   colours to convert.
  83.  
  84.